home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Memphis Amiga Group / MAG Disk (1990-01)(Memphis Amiga Group).zip / MAG Disk (1990-01)(Memphis Amiga Group).adf / showfont.doc < prev    next >
Text File  |  1989-12-29  |  13KB  |  271 lines
  1.            ShowFont 4.0 © 1989 by Arthur Johnson Jr.
  2.            =========================================
  3.  
  4.               Last update date - 07/12/89
  5.               ---------------------------
  6.  
  7.     **********************************************************************
  8.     * To see just the changes since revision ?.?, check out the improved *
  9.     * "Revisions n' Updates" section at the end of this documentation!   *
  10.     **********************************************************************
  11.  
  12. -------------------------------------------------------------------------------
  13. This program, source files, and documentation (wow) are all Copyright 1989 by
  14. myself.  The .info file was supplied by the nice people at AmigoTimes, so
  15. that's still public domain.  This program may be freely distributed, as long as
  16. the program, source, and docs are always packaged together.  If you would like
  17. to include ShowFont on a commercial product, get in contact with me by
  18. mail/phone and tell me about it.  I like to know where ShowFont is going! ;)
  19. -------------------------------------------------------------------------------
  20.  
  21.                    ShowFont
  22.                    --------
  23.  
  24.      This program allows you to quickly and painlessly view all 256 characters
  25. in a typical font.  I wrote it because using FontEd or (choke!) NotePad to see
  26. what a font looks like can be slow, tedious, monotonous, etc.
  27.  
  28.      To call this program from Workbench, double-click on its icon.
  29.  
  30.      To call this program from the CLI, type:
  31.  
  32.      ShowFont [font_name] [font_size] [font_style] <RETURN>
  33.  
  34.      [font_name] (Topaz, Ruby, etc.), [font_size] (8, 12, etc.), and
  35. [font_style] (Underlined, Bold, Italics, Extended - use the first letters) are
  36. purely optional.  If you do not specify a size, ShowFont will check all your
  37. available fonts and then show you what sizes/styles of the font you wanted
  38. exist.    If don't give a style, ShowFont will try to find the "normal" style of
  39. the font size you want.  If you omitted the font, you can select what
  40. font/size/style to see by using the font requester.
  41.  
  42.                   The Font Requester
  43.                   ------------------
  44.  
  45.      So, what's the font selector like?  Well, I've tried to make it pretty
  46. standard, including all the neat features most of the better ones have.  To
  47. select a font, size, or style, simply click on it with the left button.  When
  48. you have the desired font, size, and style selected, press the OK button.  You
  49. can also just double-click on the font, size, or style to do the same thing.
  50.      To scroll around the font, size, and style lists, click on the arrows or
  51. slider gadgets.  Since you've most likely used their like in other programs,
  52. you probably already know what they do.  Note that you can hold down the left
  53. button over these gadgets and the list will scroll rapidly in the direction of
  54. the arrow you're over.  You can also do this with the slider gadget and move up
  55. and down to scroll over the whole list.  To stop the scrolling, release the
  56. button.
  57.      If you decide you really don't want to look at a different font than what
  58. you had been checking out, press the CANCEL button.
  59.  
  60. /**************************************************************************/
  61. /* Because most everyone changes their Preferences colors, the          */
  62. /* colors I mention below might not be correct for your system.  Just      */
  63. /* translate what the colors should be on your system (if you've changed  */
  64. /* them).  The original colors were blue, white, black, and orange (in    */
  65. /* order of how you can change them in Preferences).  Just look to see      */
  66. /* what your colors are where and things should be pretty easy to      */
  67. /* understand. Then again, they may not.                  */
  68. /**************************************************************************/
  69.  
  70.      If the sizes of the font you've selected are printed in WHITE, the font is
  71. non-proportional (TOPAZ).  If they are printed in ORANGE, they are proportional
  72. (most everything else).  I added this so you can easily see what fonts you may
  73. have are non-proportional, since they are real nice when trying to make tables
  74. and stuff that needs to be columnarly [sic?] organized.  If you don't
  75. understand what I'm talking about, non-proportional fonts take up the same
  76. number of pixels per character, i.e., an 'i' takes as much space as an 'm'.
  77. Proportional fonts space the characters according to how wide they are, i.e.,
  78. an 'i' would definitely take less space to write than an 'm'.  Don't know what
  79. a pixel is?  Pixels are the small dots that can be seen if you press your face
  80. to your terminal screen.  What's a terminal screen?  Well, etc., etc.
  81.  
  82. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  83. The above explanation is a perfectly good RECURSIVE DEFINITION example.
  84. But anyway, back to the documentation.
  85. ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  86.  
  87.      Note that if you are in 2 color mode, the proportional and
  88. non-proportional size colors will be the same.
  89.  
  90.      Clicking CANCEL when you've just booted the program without any default
  91. font will cause the program to display TOPAZ 11 (if it exists).  I don't know
  92. why it doesn't use TOPAZ 8.  I've tried to tell it to many times and in many
  93. ways, but it ignores me.  C'est la vie.  But you would never do that anyway,
  94. would you?  Someday, I'll try to track down and eliminate this one-time fault.
  95. Version 4.0 note: I will soon call this a "feature" instead of a bug...
  96.  
  97.                      Menus
  98.                      -----
  99.  
  100.      For a change, I think I will try to organize this documentation a bit by
  101. listing all the menus and what each selection does. If this is too orderly for
  102. you, please call and tell me and I'll try to make it more confusing next time.
  103.  
  104. Menu    - Option          What is it?
  105. ---------------------------   -----------
  106. Project - About           Gives some useless information about the program.
  107. Project - Quit              Exits the program.
  108.  
  109. Fonts    - Change FONTS dir:   To redefine the current FONTS: directory.
  110.  
  111.  Type in where ShowFont can find the new FONTS: directory.
  112.  Examples:  df1:fonts1
  113.         dh0:fonts/myfonts
  114.  After you've pressed RETURN, click OK to accept the new FONTS: directory, or
  115. Cancel to leave without altering anything.
  116.  
  117. Fonts    - Font Selection      Brings up the font selecting requester.
  118.  
  119. Screen    - Screen Format       To change the screen size and number o' colors.
  120.  
  121.      Notice that all the menu options have short key-equivalents, i.e., you can
  122. press Right Amiga-? to select that menu selection, where ? is whatever letter
  123. is displayed after the neat Amiga symbol in the menu.
  124.  
  125.      If the font is found, ShowFont will display
  126. "font_name-font_sizefont_style" in the upper left-hand corner of the screen
  127. next to the CLOSE gadget.  To see the rest of the font (if all 256 characters
  128. cannot fit on the screen at once), use the three gadgets on the right-hand side
  129. of the screen.    Again, their function closely resembles their appearance.
  130. Fiddle around for about three seconds and you will be quite familiar and
  131. comfortable with scrolling around a font. Again, you can just hold down the
  132. button and scroll happily in whatever direction you like.
  133.  
  134.      The font_style symbols are 'u', 'b', 'i', 'e', for underlined, bold,
  135. italics, and extended, in that order.  "Normal" styles won't have anything
  136. after the size number.
  137.  
  138.      Note that actually all 256 characters will not be displayed if there are
  139. blank (empty) characters.  The program will skip them, since they are rather
  140. uninteresting, being blank.  The program will display that segment of the
  141. characters that the font says should be displayed.  Two-to-one someone has some
  142. neat secret graphics just outside the official display range, but we'll never
  143. know.
  144.  
  145.     I've added the ability to find out just how to get that neat graphics
  146. character you see.  Just click on the character, and the keys to press to
  147. produce it will appear in the window title area, also, its decimal and hex
  148. codes.    The alphabetic keys (A -> Z) will all be in upper-case.  That does NOT
  149. mean you have to (for example), press ALT-SHIFT-A when you see 'ALT-A'.  Just
  150. press the ALT and then the A keys.  Only press SHIFT when it explicitly tells
  151. you to.  The lowercase 's' and 'm' you might see refer to the SPACE BAR and
  152. KEYPAD MINUS (-), respectively (not sexual practices - whoops!).
  153.  
  154. * NOTE * Anything telling you to press CONTROL-[ALT-]_ is suspicious, as I did
  155. not have a table for the characters from decimal 0 -> 31, and 128 -> 159.  Take
  156. the "press..." advice with a grain o' salt for these characters.  If some kind
  157. soul will send me a complete keymap with those values noted, I will add them.
  158. Note that CONTROL-? or CONTROL-ALT-? means that ShowFont THINKS you press
  159. CONTROL (or CONTROL-ALT) to get that character, but does not know what
  160. particular key.  Sorry.  Someday I'll get this fixed up.
  161.  
  162.      It's come to my attention that for some fonts, what ShowFont tells you to
  163. type to get a certain character is completely wrong.  I think this may be
  164. because the programs using these fonts change the default keymap.  I'm not
  165. really sure about this, anyone having this sort of problem please alert me
  166. about it.
  167.  
  168.                    Escaping
  169.                    --------
  170.  
  171.      To exit the program, click on the CLOSE gadget or select the menu "Quit"
  172. option or press Right-Amiga-Q.    I like three ways to end a program!  Actually,
  173. you can also end the program by:
  174.      1) Control Amiga-Amiga
  175.      2) Turning off your computer's power
  176.      3) Striking the system with great force with a large, blunt object
  177. That now makes a total of six ways to terminate the program.  I'm sure clever
  178. people will find even more imaginative and useful ways to end the font session.
  179.  
  180.                    Summary?
  181.                    --------
  182.  
  183.      I guess the best advice I can give you for using and understanding this
  184. program is to type 'showfont' from CLI and fiddle around for a while until you
  185. either comprehend all the features or delete the program in a fit o' passion.
  186. In fact, most bugs are detected this way through random menu and gadget
  187. selecting.
  188.  
  189.      I'll apologize now for this rather random and odd documentation file, but
  190. I'm usually dazed and confused after my program successfully runs without any
  191. apparent bugs.    On a technical note, the Lattice 5.2 C "big" compiler and
  192. global optimizer compiled this program without comment.  I like that.  I used
  193. the following to compile the program:
  194.  
  195.    lc -g -L -M -O showfont sfstructs
  196.    fixhunk showfont
  197.  
  198.                   Thank You's
  199.                   -----------
  200.  
  201.      National Type Foundry, for sending me two font packages.
  202.      AmigoTimes, for the complimentary magazine issue (& icon).
  203.      John R. Vig, for his continued interest in the program.
  204.      J. K. Levie, for his instructional 'defdisk.c' source.
  205.  
  206.      ...and anyone else who just needs/wants a 'Thank You!'
  207.  
  208.                How to Locate the Author
  209.                ------------------------
  210.  
  211.      That's it!  Any comments/questions/suggestions/flames/improvements/etc.,
  212. can be directed to the following address:
  213.  
  214.              *****************************
  215.              * Arthur Johnson Jr.         *
  216.              * 225 Montego Bay Court     *
  217.              * Merritt Island, FL  32953 *
  218.              *    (407) 277-0548       *
  219.              *****************************
  220.  
  221.  
  222. Arthur Johnson Jr. -=> {uiucuxc, hoptoad, petsd}!peora!rtmvax!bilver!alj
  223. -=-=-=-=-=-=-=-=-  -=> alj@bilver.UUCP
  224.            -=> PLink: DUNG
  225.            -=> GEnie: A.JOHNSONJR
  226.  
  227.      I don't frequent the message bases on PLink or GEnie, so E-MAIL me on
  228. those two systems.
  229.  
  230.                  Revisions n' Updates
  231.                  --------------------
  232.  
  233. Version 4.0 : Added an error requester to inform you of certain recoverable
  234.            errors instead of exiting the program disgracefully.
  235.           Told ShowFont how to handle font sizes with multiple styles
  236.            nicely.
  237.           Included the ability to change the FONTS: dir from inside
  238.            ShowFont.  Currently, when you leave the program, FONTS: will
  239.            still be pointing to wherever you told ShowFont to look for it.
  240.           Now you can change the number of colors the screen has, for color
  241.            font support sometime in the future.  And, two-color screens
  242.            really haul when scrolling around!
  243.           Moved the "To get that key..." information to the title bar, and
  244.            included the key codes for my own obscure purposes.
  245.  
  246. Version 3.3 : Fixed a bug that caused ShowFont to lump similarly-named fonts
  247.            together (whoopsie!).
  248.           Added "To get that character, press..." feature.
  249.  
  250. Version 3.2 : Eliminated slider gadgets happy post-release flickering.
  251.           Returned a satisfactory response to the system when exiting from
  252.            a RUN-ned ShowFont, exterminating that error message.
  253.           Polished the code up quite a lot for some noticeable speed and
  254.            size improvements.
  255.           Worked on the documentation some more (this will be assumed for
  256.            all future versions)
  257.           Discarded the somewhat useless and potentially dangerous "Read
  258.            FONTS:" menu option.
  259.           A few other little thingies.
  260.  
  261. Version 3.1 : Fixed a bug in the 'Read FONTS:' menu selection.
  262.           Added "double-clicking" selection method.
  263.           Cleaned up the documentation a bit.
  264.  
  265. Version 3.0 and below : These records were destroyed in the great fire,
  266.              earthquake, plague, hurricane, tsunami, volcanic
  267.              eruption, insect infestation, computer virus,
  268.              meteorite strike, supernova, tornado, and alien attack
  269.              of 1988.  I apologize for any inconvenience this may
  270.              cause.
  271.